Bernie ][ The Rescue 2.5.1

                                      ÒOnly Emulation
                                       Can Get Past
                                       The Original.Ó



please see end of document for License Agreement and contact information



Welcome!

Thank you for downloading Bernie ][ The Rescue 2.5, the premier Apple IIgs¨ emulation software for Power Macintosh¨ computers!

Version 2 is the next-generation Apple II. We're happy to share our efforts with you.

Unlike with previous releases, we have included the complete User's Manual with the Bernie archive. The manual is made up of HTML files that you can view offline with your favorite browser. The manual is stored in the "Documentation" directory. To view it, open the file "I am the manual.html" with your web browser.

If you are new to Bernie and are unsure what you need in order to get started with Apple IIgs emulation, you might want to consider ordering the pretty unique Bernie Starter Kit CD-ROM from Shareware Solutions II. It includes about everything you want to have (except for the ROM dump) and has been specifically made for people who tend to avoid hassle. The CD is priced at only US$25 and comes with Bernie, the HTML documentation, utilities, system software, applications and more. A CD with registration included is also available at US$60. The CD has been thoroughly checked by the Bernie boys and is considered a must-have. [official paw stamp goes here]

Many thanks go to those who helped us with version 2 and previous releases. Think of Richard Bennett of Marinetti fame and Ewen Wannop of Spectrum fame who took an active part. There've been a lot, lot - probably more than you would think - people showing tremendous support. Big thanks to all registered users who joined us. 



Changes


What's New In Version 2.5.1

¥ Bernie Total Integration makes its debut. You can now drag & drop files and exchange
  clipboard content easily. See below for an introduction and the manual for complete information.
¥ We have thrown in a better algorithm for volume control. You should experience louder,
   more steady playback regardless of how many voices are playing. The new algorithm is still
   in fine-tuning mode, please get back to us if it's not delivering on your end. 
¥ Another change in the sound department is that sound is now always enabled. You can mute
   sound emulation, but interrupts are generated. This addresses problems some have encountered
   when a software was waiting for sound interrupts to occur and it looked like Bernie went belly
   up. The "mute" mode is quite a bit faster than mono playback.
¥ adaptive sound level smoothing
¥ automatic channel balancing
¥ Fixed DTR setting not being properly dealt with in preferences sets
¥ Fixed bug in window code that lead to close boxes having no effect
¥ Fixed Easter Egg so you can turn it off
¥ internal reorganizations. The usual code schmoozing, you know.
¥ version 2.5.1: fixed bug where ProDOS 8 apps would not start when launched from IIgs Finder

What Was New In Version 2.0.2

¥ Fix for shared volumes in ProDOS 8.

What Was New In Version 2.0.1

¥ SpeedNanny now works properly.
¥ Marinetti now emulates properly (did use to freeze when hanging up)
¥ Bernie now incorporates a fix for the "repeating keys" phenomena that Apple deliberately
   chose not to take care of in MacOS
¥ The modifier keys are discarded when Bernie is in the background
¥ Interrupts are better dealt with when Bernie is grasping for CPU resources
   (for example when opening menus, collapsing windows etc.)

What Was New In Version 2.0

This version fixes some issues with the original version 2.0 prerelease:

¥ Bernie froze when trying to switch to Power Mode with extended border active on a system with monosync 14" monitor. Instead of going belly up, Bernie deactivates Extended Border.
¥ help balloon for SpeedNanny was misleading
¥ automatic disk initialization for 32Mb disk images failed. Instead of creating 32Mb, Bernie will now allocate 31.5 Mb. The overflow the full 32Mb disk image caused will be fixed in the final version 2.0.
¥ baud rate was randomized with InkDirectª upon choosing a parity.
¥ dialog boxes for successful/unsuccessful registration are back
¥ window update flaw fixed



Limitations Of The Unregistered Version

You can use Bernie unregistered for evaluation purposes. If you think Bernie delivers (hey, it does..), you might want to register it. Before you're doing so, however, some features are not available:

¥ Bernie does not save Preferences to disk. Every time you start a new Bernie session, it reverts to the default settings. Most notably, "Low-Level Disk Support" is enabled by default which you should probably disable. (With Low-Level Disk Support enabled, Bernie recognizes 800k disks only. It's a special mode for running FTA demos and some other non-standard software, but usually you should disable it for running GS/OS and most other applications.)

¥ You can't connect a serial port or use InkDirectª: the port selection popups do not list available serial ports of your Mac. Communications support is only available in the registered release.

¥ Bernie quits after 30 minutes: it just says goodbye. Because this might cause loss of data, we do not recommend doing serious stuff with unregistered Bernies. Bernie does not offer you a chance to save your work after 30 minutes.

¥ No default startup disk: you can select a default startup disk but Bernie won't remember it. This basically means that this feature is not available.



Turning This Demo Into The Real Thing

Now that you downloaded Bernie, you might want to turn it into the full, no-limits variant. How so?

All you need is to register Bernie. Upon registering Bernie, you will receive an unlock code from F.E.Systems that turns your current demo version into the full version. To register your copy, hop to the secure online shopping page at http://order.kagi.com/?XF and there you go.




Very Very Important Registration Info


Registering Bernie is almost as complicated as writing your own emulation software, but we have tried to provide to-the-point information in this matter. Information on how to register your copy is not part of this document, however. To learn how you can register your copy, please read the chapter "Registering" located in the Bernie User's Manual.

Our company teamed up with Kagi Shareware, a company specialized in processing shareware fees. There are some important details that often lead to added overall confusion:

¥ We can only register your software if you a) have a permanent e-mail address or b) order the preregistered CD-ROM from Shareware Solutions II

This restriction is not meant to discriminate people without e-mail account but to make our lifes easier. Since we do not correspond in postal mail, we need to send you your unlock code via e-mail. The same applies to all technical support and inquiries: e-mail only. If you do not have a permanent e-mail address, you can still order Bernie from Shareware Solutions II in form of a CD-ROM. The CD-ROM is priced at US$60 and includes the required license.

¥ The full, end of all registration information is in the User's Manual

For concrete details on how to order Bernie online, per e-mail, fax or postal mail is outlined in the "Registering" section of the User's Manual. The manual is available online (http://www.magnet.ch/emutech/Bernie/Documentation/) or included with this archive.

¥ Kagi does not know what an Apple II is, what Bernie is, who we are

If you have technical questions or any other comments that do not directly concern your order, please contact us. We are eagerly waiting for your e-mails at emutech@magnet.ch for registration questions and woof@kagi.com for technical support. (Note: though woof@kagi.com seems to be affiliated with Kagi, it is not. It will be forwarded to our mailboxes.)

¥ The Register application

The Bernie archive includes a small application that takes your order and brings it into an electronic form that can be processed by Kagi automatically. 

¥ Educational pricing: Please e-mail before ordering

Yes, we have special prices for educational institutions. A computer lab (15 licenses max.) is $150. Site licenses vary with kind of institution and special arrangements - please e-mail us for details at <emutech@magnet.ch>. Individual licenses are available at $15 each (min. 2 per order).
Whatever meets your needs, please e-mail F.E.Systems at <emutech@magnet.ch> before placing educational orders. Thank you!




New Features At A Glance


Bernie Total Integration (BTI) is a new technology that simplifies the daunting task of sharing information between the Apple IIgs and Mac layers. BTI allows you to:

¥ drag&drop files and folders from the Mac into a GS/OS disk
¥ drag&drop files and folders from a GS/OS disk into a Mac disk
¥ paste the Mac clipboard into IIgs desktop applications
¥ paste the clipboard of IIgs desktop applications into Mac applications

BTI consists of two code modules. One half of BTI is built into Bernie while the remaining code is embedded into a GS/OS system extension. In other words, BTI is not immediately available in every GS/OS setup. Instead you do need to install the BTI system extension in the system folder in order to take advantage of it.
The BTI system extension is not compatible with earlier versions of Bernie. If BTI has been installed properly, Bernie will show a message "Bernie Total Integration ready" when starting from a BTI-enhanced system disk. The system disk does not apply any permanent patches.


Exchanging Clipboards

Bernie extends the standard File menu of Apple IIgs desktop applications with a hotkey, the option key. When holding down the option key and choosing Copy or Paste, Bernie will...

¥ copy the selected text to the IIgs clipboard and to the Mac clipboard or
¥ paste the Mac clipboard

BTI does only support ASCII text at this time. You can't copy&paste pictures or styled text.

BTI interfaces with standard toolbox commands and therefore only works with applications that rely on them. Applications that implement their own clipboard do not work with BTI.


File Drag & Drop

A true time saver is Bernie's new capability of copying files directly between GS/OS and the Mac. To copy files you must be running the Apple IIgs System 6.0 or 6.0.1 (recommended).


Copying Files From The Mac to The Apple IIgs

It only takes a couple of mouse clicks:

¥ in the Apple IIgs Finder, open the Finder window with the destination directory
¥ on the Mac, select the files you'd like to copy, drag them onto the IIgs Finder window and drop them

Bernie will then copy all files. If the selection included directories, Bernie will copy all files within that directory as well. This operation may take some time. You can't work with Bernie while the copy operation is still in progress.

BTI also allows for file copies when the Finder is not the current application, or when the Finder is running but you did not open a directory window. In that case Bernie is putting all files inside the folder...

:StartupDisk:Bernie.Transfer:

Please keep in mind that BTI is a GS/OS thing and not available in ProDOS or DOS 3.3 applications.


Copying Files From The Apple IIgs To The Mac

Copying files to the Mac is not as straightforward as the other way around, but you won't need a Ph.D. either. The basic idea is that Bernie will watch out for a special folder titled "Bernie.Transfer". (This is the same folder we talked about before.) Whenever you copy a file into that folder, it will be copied to a Mac disk instead. You can create an abundant amount of these transfer folders as the absolute path does not matter. You might even want to create one on the Finder desktop. Bernie creates a transfer folder in the startup disk's root folder on its own - this is the preferred location.
To copy files, follow these steps:

¥ make a "Bernie.Transfer" folder visible for a later drag&drop
¥ in the IIgs Finder, select the files you'd like to copy to the Mac
¥ drag them onto the Bernie.Transfer folder and drop them
¥ Bernie will ask you for a destination and starts copying the files

Please see the Bernie Manual for a detailed description of file drag & drop.


Sound Emulation

As noted before there are internal changes concerning sound emulation. The volume control is now based on a non-linear model and delivers constant volume across all Ensoniq loads. Since volume calculation is largely based on probabilities and bandwith usage of the individual waves, the current settings reflect what we found the best setup. If you are experiencing difficulties, please drop us a line.
As with earlier versions, the volume settings "Louder" and "Did I say loud?" are very likely to produce scratches because of their excessive amplitude scaling. The clipping is part of the process and you should only use these volume settings when using software that is chronically playing in the lower decibels.
The volume control now has a much greater resolution.




Woof!

20/9/99,hg
________________________________________________________________________________


F.E.Systems Emulation Technologies
http://www.magnet.ch/emutech
AOL Instant Messenger: FE Systems

Bernie home page: http://www.magnet.ch/emutech/Bernie
Download: http://www.magnet.ch/emutech/Download
Support: http://www.magnet.ch/emutech/Support
Feedback: http://www.magnet.ch/emutech/Feedback
Mailing List: http://www.magnet.ch/emutech/Bernie/List


License Agreement

Bernie ][ The Rescue is a trademark of F.E.Systems Horstmann & Gudat  ("F.E.Systems hereafter".) The software is distributed as is without warranties as to performance or fitness to a particular purpose. The user, and not F.E.Systems, assumes the entire risk for loss of data, servicing, repair , incidental and consequential damages. The Bernie ][ The Rescue archive may not be included on CD-ROMs and other high-capacity media (>2Mb) without prior written permission from F.E.Systems. Electronic distribution only with prior written permission from F.E.Systems. Permission for CD-ROM distribution of Bernie ][ The Rescue 2.0.2 granted to MacWorld UK and MacAddict.

Software and documentation © 1996-1999 F.E.Systems. Diversi-Tune is a trademark of Diversified Software Research. AppleWorks, Apple, Macintosh, MacOS, Apple IIgs, ProDOS, DOS 3.3 are trademarks of Apple Computer, Inc. InkDirect, CerealPuffs, MuesliPump, ViagRAM, Sweet16, Bernie ][ The Rescue are trademarks of F.E.Systems Emulation Technologies Horstmann & Gudat.